Skip to content

docs: add shape and label styling tutorial - #16

Open
timtreis wants to merge 2 commits into
mainfrom
feat/styling-tutorial
Open

docs: add shape and label styling tutorial#16
timtreis wants to merge 2 commits into
mainfrom
feat/styling-tutorial

Conversation

@timtreis

Copy link
Copy Markdown
Member

Summary

Adds tutorials/styling_shapes_and_labels.ipynb — the styling counterpart to the colour tutorial. Where color_and_palette covers what colour an element gets, this covers how it is drawn.

Covers the fill/outline surface of render_shapes and render_labels on the blobs dataset:

  • fill_alpha — fill opacity, for both shapes and labels
  • the outline bool toggle (restored for shapes and labels in #750) with outline_width / outline_color / outline_alpha
  • hollow shapes (transparent fill + outline)
  • scale — resizing shape geometries about their centroids
  • segmentation boundaries on labels via outline + contour_px, and the translucent-fill-plus-outline overlay over an image

Executed against spatialdata-plot v0.4.1, committed with outputs. Adds the gallery card + toctree entry and a 552×496 thumbnail.

Scope: deliberately leaves color=/palette/groups to the colour tutorial and points styling to the as_points tutorial (#15), to avoid overlap.

Part of the 0.4.1 feature-tutorial series (after multi-panel colour #14 and normalization #9).

New tutorials/styling_shapes_and_labels.ipynb covering the fill/outline
styling surface of render_shapes and render_labels on the blobs dataset:

- fill_alpha for both shapes and labels
- the outline bool toggle (restored for shapes and labels in #750) with
  outline_width / outline_color / outline_alpha
- hollow shapes (transparent fill + outline)
- scale for resizing shape geometries about their centroids
- segmentation boundaries on labels via outline + contour_px, and the
  translucent-fill-plus-outline overlay over an image

Executed against spatialdata-plot v0.4.1; committed with outputs. Adds the
gallery card + toctree entry and a thumbnail. Deliberately leaves color=/
palette/groups to the colour tutorial and points styling to as_points.
@review-notebook-app

Copy link
Copy Markdown

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@github-actions

github-actions Bot commented Aug 18, 2026

Copy link
Copy Markdown

📖 Docs preview: https://scverse.org/spatialdata-plot-tutorials/pr-16/gallery.html

Built from 67c103d; redeployed on every push.

github-actions Bot pushed a commit that referenced this pull request Aug 18, 2026
…erlay demo go below default, drop internal jargon
github-actions Bot pushed a commit that referenced this pull request Aug 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant